2021.1.3 Maintenance Release [2021-10-05]

Changelog Overview

• 6 New Features
• 6 Improvements
• 29 Bug Fixes
• 7 Chores
• 3 Tests
• 51 Total Tickets

New Features

• adapter-email:3.1.20-2021.1.1 [09-27-2021] - The adapter-email can now listen to email accounts and generate RabbitMQ notifications back to IAP.
• app-automation_catalog:2.10.6-2021.1.5 [09-10-2021] - Implemented an internal process utility to enable importing.
• app-configuration_manager:3.74.24-2021.1.14 [09-21-2021] - Created new methods to handle processing and importing of Golden Configurations.
• app-jst:1.3.10-2021.1.33 [09-27-2021] - Introduced an internal processing function to improve the usability of transformations with IAP Pre-builts.
• app-operations_manager:1.47.0-2021.1.38 [09-10-2021] - Implemented internal process Automations API to integrate with Pre-builts.
• app-service_catalog:3.10.19-2021.1.1 [09-10-2021] - Implemented an internal process utility to import a list of service catalog items.

Improvements

• app-admin_essentials:2.25.42-2021.1.24 [09-16-2021] - Fixed an issue where Task Execution in Admin Essentials was not reflecting the correct status.
• app-automation_studio:3.35.20-2021.1.51 [09-17-2021] - Added tooltips to distinguish the different types of groups found in a workflow.
• app-automation_studio:3.35.20-2021.1.47 [09-07-2021] - Added schema validation to the Child Job Loop Settings UI when using a JST.
• app-workflow_engine:9.6.32-2021.1.74 [09-27-2021] - Separated the lodash dependency into the lodash.has and lodash.set dependencies.
• itential-utils:2.7.2 [09-23-2021] - Added a healthCheck call to the PropertyEncryption.js to support getting the status of Vault from IAP.
• pronghorn-core:12.1.24-2021.1.42 [09-24-2021] - Added Vault health information to the /status API.

Bug Fixes

• adapter-email:3.1.20-2021.1.2 [09-27-2021] - Updated pronghorn.json to fix required field schema error.
• app-automation_catalog:2.10.6-2021.1.7 [09-17-2021] - Fixed typo error in schema for runWorkflow endpoint.
• app-automation_catalog:2.10.6-2021.1.6 [09-17-2021] - Fixed incorrect rendering of toast messages upon automation creation.
• app-automation_studio:3.35.20-2021.1.61 [10-04-2021] - Pending nodes no longer cause errors when deleting nodes on the Gen2 canvas.
• app-automation_studio:3.35.20-2021.1.60 [10-04-2021] - Creating new forms without permissions no longer crashes the app.
• app-automation_studio:3.35.20-2021.1.58 [09-30-2021] - Refactored the JST task to correctly display JST input. When selecting a transformation on the transformation task, the JST variables are now properly assigned.
• app-automation_studio:3.35.20-2021.1.57 [09-27-2021] - Error handling is fixed for all JSON Form endpoints.
• app-automation_studio:3.35.20-2021.1.56 [09-24-2021] - App no longer crashes when dragging an item off-canvas and then returning to the canvas with a different mouse state. The click state will reset once the cursor is re-established on the canvas.
• app-automation_studio:3.35.20-2021.1.54 [09-23-2021] - Sorting workflows is now consistent across all apps.
• app-automation_studio:3.35.20-2021.1.53 [09-21-2021] - Fixed error reporting when importing an invalid template or JSON Form item.
• app-automation_studio:3.35.20-2021.1.52 [09-20-2021] - When JSON Form is deleted, document tab is closed and the app navigates to the next opened tab instead of resetting (redirecting) to the Automation Studio home page.
• app-automation_studio:3.35.20-2021.1.50 [09-14-2021] - Corrected the spelling for Create a Workflow on the Automation Studio homepage.
• app-automation_studio:3.35.20-2021.1.49 [09-09-2021] - Unavailable tasks in recently used tasks are now hidden on the Gen 2 canvas.
• app-operations_manager:1.47.0-2021.1.42 [09-24-2021] - Fixed exports for triggers with no configured JST or JSON form.
• app-operations_manager:1.47.0-2021.1.41 [09-24-2021] - Fixed an issue were the enter key would submit changes instead of adding a new line. Refactored the enter and escape keyboard behavior.
• app-operations_manager:1.47.0-2021.1.40 [09-23-2021] - Added support for keys containing '$' in trigger schemas.
• app-operations_manager:1.47.0-2021.1.39 [09-21-2021] - The notification dialog that displays a success/failure message after starting an automation is visible until the user closes it. Also improved visibility of the job details link that displays in the dialog window.
• app-workflow_builder:5.40.5-2021.1.28 [09-24-2021] - Fixed Templates list in side navbar when reviewing a Gen 1 workflow.
• app-workflow_builder:5.40.5-2021.1.27 [09-16-2021] - Implemented a fix to prevent UI errors after deleting child job reference variables.
• app-workflow_builder:5.40.5-2021.1.26 [09-13-2021] - Transformations can now be searched by ID in Gen 1 workflows.
• app-workflow_engine:9.6.32-2021.1.75 [09-27-2021] - Added a migration script for active jobs to handle upgrades across RabbitMQ re-architecture.
• app-workflow_engine:9.6.32-2021.1.72 [09-21-2021] - Fixed bug where Job Errors of a type object were not properly displayed.
• pronghorn-core:12.1.24-2021.1.45 [10-04-2021] - Fixed bug where the propertiesSchema for a service was not properly de-structured.
• pronghorn-core:12.1.24-2021.1.44 [10-02-2021] - Corrects an issue where forms created in 2020.2.6 or earlier do not work in 2020.2.7. Additionally addressed newly-created forms in 2020.2.7 with nodes context in XPath expressions.
• pronghorn-core:12.1.24-2021.1.43 [09-29-2021] - Updated error message when Mongo user does not have proper permissions.
• pronghorn-core:12.1.24-2021.1.41 [09-21-2021] - Fixed an issue where integrations would deplete the thread pool due to an error. This fix will set the worker threads back to ready after they complete a request or recover from an error. .
• pronghorn-core:12.1.24-2021.1.40 [09-21-2021] - Improved error handling on Transformations Collection Index APIs. Error is thrown when no predefined indexes exist for a requested collection.
• pronghorn-core:12.1.24-2021.1.39 [09-20-2021] - Added a time range validation check to the core scheduler. ScheduleTask is now executing correctly at the scheduled time.
• search:1.1.14-2021.1.1 [09-14-2021] - Modified the way search indexes are created for a global search.

Chores

• app-admin_essentials:2.25.42-2021.1.23 [09-09-2021] - Migrated page navigation to React Router.
• app-automation_studio:3.35.20-2021.1.59 [10-01-2021] - Updated JST Designer dependency to latest version.
• app-automation_studio:3.35.20-2021.1.56 [09-24-2021] - Updated jst-designer dependency to latest version.
• app-automation_studio:3.35.20-2021.1.48 [09-07-2021] - Updated JST and jst-designer dependencies to latest version.
• app-jst:1.3.10-2021.1.32 [09-24-2021] - Updated jst-designer dependency to latest version.
• app-jst:1.3.10-2021.1.31 [09-07-2021] - Updated JST and jst-designer dependencies to latest version.
• app-workflow_engine:9.6.32-2021.1.71 [09-20-2021] - Updated deprecation notice to indicate the migrateProperties script is still needed.

Tests

• app-workflow_engine:9.6.32-2021.1.76 [09-27-2021] - Refactored tasksClaim.post.js to use updated API.
• app-workflow_engine:9.6.32-2021.1.73 [09-22-2021] - Refactored test coverage of API routes in workflow engine for getTaskIterations.get.js.
• app-workflow_engine:9.6.32-2021.1.70 [09-10-2021] - Fixed API tests for childJob looping.

2021.1.3 Release Versions

Automation Platform Versions

component	version
@itential/adapter-automation_gateway	4.17.1-2021.1.2
@itential/adapter-azure_aaa	1.1.9-2021.1.0
@itential/adapter-email	3.1.20-2021.1.2
@itential/adapter-ldap	2.12.21-2021.1.2
@itential/adapter-local_aaa	4.2.8-2021.1.1
@itential/adapter-nso	7.1.3-2021.1.2
@itential/adapter-radius	2.0.12-2021.1.0
@itential/adapter-redis	2.0.17-2021.1.0
@itential/app-admin_essentials	2.25.42-2021.1.24
@itential/app-ag_manager	1.13.0-2021.1.2
@itential/app-automation_catalog	2.10.6-2021.1.7
@itential/app-automation_studio	3.35.20-2021.1.61
@itential/app-configuration_manager	3.74.24-2021.1.14
@itential/app-form_builder	4.10.1-2021.1.6
@itential/app-json_forms	1.30.12-2021.1.8
@itential/app-jst	1.3.10-2021.1.33
@itential/app-mop	6.10.2-2021.1.7
@itential/app-nso_manager	2.20.15-2021.1.2
@itential/app-operations_manager	1.47.0-2021.1.42
@itential/app-service_catalog	3.10.19-2021.1.1
@itential/app-service_management	2.24.0-2021.1.1
@itential/app-template_builder	2.5.3-2021.1.3
@itential/app-workflow_builder	5.40.5-2021.1.28
@itential/app-workflow_engine	9.6.32-2021.1.76
@itential/pronghorn-core	12.1.24-2021.1.45
@itential/search	1.1.14-2021.1.1
@itential/tags	3.1.4-2021.1.0
@itential/itential-utils	2.7.2

Automation Gateway Versions

component	version
automation_gateway	3.130.2+2021.1.16

NSO Manager Versions

component	version
itential-tools	1.23.31.2021.1.3

Engine Versions

component	version
policy-engine	1.10.7+2021.1.0

Dependencies

Automation Platform Server

package	supported versions	recommended version
nodejs	>= 12.22.1 <= 14	14.17.3
npm	6.x	6.14.15
python	2.x or 3.x	3.9.7

pip	supported	recommended
pip	any version	21.1.3
textfsm	1.x	1.1.2
Jinja2	2.x	2.11.3

The gcc-c++ and make packages should be installed from your OS distribution.

Mongo Server

package	supported	recommended
mongodb	4.2.x	4.2.13

RabbitMQ Server

package	supported	recommended
rabbitmq	3.8.x	3.8.14
erlang	21.3+ or 22.x	22.3.1
elixir	1.10.x	1.10.4
dedup	0.5.x	0.5.0

Redis Server

package	supported	recommended
redis	5.x	5.0.12

The gcc-c++ and make packages should be installed from your OS distribution.

Hashicorp Vault

package	supported	recommended
vault	1.x	1.7.0

Automation Gateway

package	supported	recommended
python	3.9	3.9.7
openssl	1.x	1.1.1l
haproxy	2.x	2.2.14

The gcc-c++ and make packages should be installed from your OS distribution.

The following development packages are required to install automation gateway: libffi-dev, openssl-dev, python-dev, sqlite-dev.

pip package	supported	recommended
pip	20.2.4	20.2.4
ansible	2.9 or 2.10	2.10.7
terraform	0.12.x	0.12.31
nornir	3.x	3.1.1
netmiko	3.x	3.4.0

One or more of the following packages may be required by the specific ansible modules you're using: psutil, pycrypto, paramiko, ncclient, lxml, nitrosdk-python, jxmlease.

Check the ansible documentation for the roles you're planning to use for additional package requirements.

NSO/Itential Tools

package	supported	recommended
java	1.7 or 1.8	1.8.275.01

The ant package should be installed from your OS distribution.

IAP Compatibility

Device Configuration

Device Configuration compatibility describes which devices are expected to work with the basic features of the Configuration Manager application across various southbound systems.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

Refer to the NSO Versions and NED Versions tables below for a list of tested devices.

Device Compliance

Device Compliance compatibility describes which devices are expected to work with Golden Configurations.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Configuration Manager app):

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

Device Maintenance

Device Maintenance compatibility describes which devices Itential can perform maintenance activities on (e.g., reboots and firmware upgrades).

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Juniper Junos

NSO:

* cisco-ios
* cisco-iosxr
* juniper-junos

Device Health Checks

Device Health Checks compatibility describes which devices Itential can execute read-only show commands to use the method broker and Command Templates application.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

* a10-acos
* alu-sr
* arista-dcs
* cienacli-acos
* cisco-aireos
* cisco-asa
* cisco-gss
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-qps
* cisco-staros
* ericsson-sgsnmme
* f5-bigip
* huawei-vrp
* juniper-junos

Note: Some of the devices in the health checks category are tested against netsim devices.

Forms

Ansible:

IAP can render most ansible networking modules as forms. Support for specific modules may vary. If you encounter issues with any particular modules, reach out to the Itential Customer Success Team for assistance.

NSO:

IAP can render most service models advertised by NSO as forms. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Service Provisioning

NSO:

IAP can provision most service models advertised by NSO. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Devices/Services Compatibility

The Itential Automation Platform is tested against the following component versions.

Ansible Versions:

* 2.10.7
* 2.9.26

Ansible Modules:

* eos_facts
* eos_command
* eos_config
* ios_facts
* ios_command
* ios_config
* iosxr_facts
* iosxr_command
* iosxr_config
* nx_facts
* nx_command
* nx_config
* junos_facts
* junos_command
* junos_config

NSO Versions:

* 5.4.4
* 5.5.1

NSO NED Versions:

ned	5.4.4	5.5.1
a10-acos	3.18	3.18
adtran-aos	4.0.6	4.0.6
alu-sr	8.13.4	8.13.4 8.13.3
arista-dcs	5.20.2	5.20.2 5.20
checkpoint-gaiaos_rest	n/a	1.10.7 1.10.6
ciena-acos	6.2.5	6.2.5 6.2.4
cisco-aireos	3.7.2 3.7.1	3.7.2 3.7.1
cisco-asa	6.12.4	6.12.4 6.12.3
cisco-gss	2.1.1	2.1.1
cisco-ios	6.69 6.68.2	6.69 6.68.2
cisco-iosxr	7.33	7.33 7.32.5
cisco-nx	5.21.1	5.21.1 5.21
cisco-qps	5.1.3	5.1.3
cisco-staros	5.34.6 5.34.5	5.34.6 5.34.5
ericsson-sgsnmme	1.0.7	n/a
f5-bigip	3.17 3.16	3.17 3.16
fortinet-fortios	5.4.21	5.4.21 5.4.20
huawei-usn	1.2.1	n/a
huawei-vrp	6.17.4 6.17.3	6.17.4 6.17.3
juniper-junos	4.6.19 4.6.17	4.6.19 4.6.17
paloalto-panos_cli	4.8.2 4.8.1	4.8.2 4.8.1
radware-alteonos	2.4.1	2.4.1 2.4
unix-bind	2.1.0	2.1.0

VTS Versions:

* 2.6.2

VTS NED Versions:

ned	2.6.2
cisco-iosxr	6.6
cisco-ncs5500	1.0
cisco-nx	5.1.4

Virtual Devices:

* A10 vThunder 4.1.4 GR1
* Arista EOS-4.23.0FX
* Checkpoint R80.30-273.583
* Cisco ASAv 9.13.1.7
* Cisco CSR 17.02.01r
* Cisco NX 9.3.2, 9.3.1
* Cisco StarOS 21.15.29
* Cisco XR6.3.1
* F5 BIGIP 15.1.0.2-0.0.9
* Fortigate 6.4.0
* Juniper VMX 18.4R1
* Juniper VSRX 19.1R2
* PanOS 9.1.2
* Radware 32.6.0.0

IAP Browser Compatibility

This maintenance release was tested against the following browser versions:

* Firefox 89
* Chrome 91.0.4472.77
* Edge 91.0.864.37
* Internet Explorer 11